home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / srch132s.zip / SEARCH.DOC < prev    next >
Text File  |  1989-02-12  |  35KB  |  1,189 lines
  1.  
  2.          SEARCH - The BBS Message Searcher Version 1.32        Page -1-
  3.  
  4.              Copyright (C) 1989 by Don Lewis.  All rights reserved.
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                 Documentation for
  22.                               BBS message SEARCHer 
  23.  
  24.                                Copyright (C) 1989
  25.                                        by
  26.                                     Don Lewis
  27.  
  28.                                 5207 Mossgrey Ln.
  29.                                Spring, Tx.  77373
  30.                         AC 713-353-5295 (after 6:00 P.M.)
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                                   *** NOTE ***
  40.  
  41.         This program is SHAREWARE, not FREEWARE! It is Copyrighted and
  42.         remains my property.  If you try it, and find it useful, please
  43.         send $10.00 to me at the above address and I will send you the
  44.         latest version on disk.  If you do not find SEARCH useful, please
  45.         pass the .ARC file on to someone who needs it.
  46.  
  47.             *** Once a registered user, always a registered user. ***
  48.  
  49.         I have a number of ideas to add to SEARCH, and I plan to continue
  50.         to release new versions of SEARCH (if enough people find it use-
  51.         ful and register).  Registered users may update to the latest
  52.         version by sending me the original distribution disk and a
  53.         stamped, self-addressed floppy disk mailer.
  54.  
  55.         I will gladly provide telephone support to registered users.
  56.         Unregistered users who are having problems can take their
  57.         chances.  Anyone who suggests a useful modification which I use
  58.         in a later version receives the latest version on disk and
  59.         becomes a registered user.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.          SEARCH - The BBS Message Searcher Version 1.32        Page -2-
  69.  
  70.              Copyright (C) 1989 by Don Lewis.  All rights reserved.
  71.  
  72.  
  73.  
  74.                    ********    NOTICE:    ********
  75.  
  76.         The following describes the legal basis under which SEARCH and
  77.         its associated files is distributed.  If you disagree with these
  78.         terms, please destroy all copies of the files, all printed mate-
  79.         rial and forget you ever heard of this...
  80.  
  81.                                 Thanks
  82.                                        /Don Lewis
  83.  
  84.         Now for the legal-eagle detail...
  85.  
  86.         SEARCH is provided on an "as is" basis without warranty of any
  87.         kind, express or implied. In no event will Don Lewis (hereafter
  88.         referred to as the Author), be liable to you for any damages,
  89.         including any lost profits, lost savings or other incidental or
  90.         consequential damages arising out of the use of or inability to
  91.         use SEARCH, even if the Author has been advised of the possibil-
  92.         ity of such damages, or for any claim by any other party.
  93.  
  94.         Your use of SEARCH is at your own risk, and by your use of it,
  95.         you agree to indemnify and hold harmless the Author, his heirs
  96.         and assigns from any legal action arising from your use of SEARCH
  97.         for any purpose whatsoever.
  98.  
  99.         The version of SEARCH referenced in this document supersedes all
  100.         previous versions.  The Author advises that all previous versions
  101.         of SEARCH be destroyed. 
  102.  
  103.         Whew!  I hope that deflects the hungry lawyers to a more helpless
  104.         target (or one with deeper pockets).
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.          SEARCH - The BBS Message Searcher Version 1.32        Page -3-
  135.  
  136.              Copyright (C) 1989 by Don Lewis.  All rights reserved.
  137.  
  138.         SEARCH was written to deal with a problem I had as I was doing
  139.         Genealogy research.  There were so many messages posted on a
  140.         local Bulletin Board from the National Genealogy Conference, that
  141.         I used all my on-line time each day just reading.  I decided to
  142.         capture all the new messages and read them offline.  That took
  143.         much less online time, but then I had to read through 
  144.         ** HUNDREDS ** of messages looking for those few which referred
  145.         to something I needed.
  146.  
  147.         SEARCH quickly reads all those messages for me now, compares each
  148.         one to a list of words I am looking for, and then makes a file
  149.         containing ** ONLY ** those messages which matched.
  150.  
  151.         SEARCH should also be useful to CompuServe(c) users, GEnie(c)
  152.         users, members of The Source(c), or anyone who uses a BBS which
  153.         handles lots of messages.
  154.  
  155.         Preparing to use SEARCH
  156.         -----------------------
  157.  
  158.         Like everything designed to save time, a little effort must be
  159.         spent getting ready.  To keep SEARCH relatively small and fast, I
  160.         have not used elaborate error-checking for files that you will
  161.         create.  Please carefully follow the steps below, and your trou-
  162.         bles will be few...
  163.  
  164.               1)    Using your terminal program (I'll not attempt to
  165.                     instruct on that, as there are a myriad of different
  166.                     terminal programs), dial up your BBS.  Select the BBS
  167.                     command to read messages without stopping, and have
  168.                     your terminal program capture the messages in a file
  169.                     having the following name:
  170.  
  171.                           MMMDD.NNN
  172.  
  173.                        where:
  174.                            MMM is the three-letter month name e.g. JAN
  175.                            DD  is the two-number day-of-the-month e.g. 10
  176.                            NNN is the three-letter BBS name abbreviation
  177.                                e.g. PST for PasTracks
  178.                                     TRS for TreeShare
  179.  
  180.                     Thus, the file I captured from PasTracks on January
  181.                     10, 1989 is named JAN10.PST
  182.  
  183.                                   *** Note ***
  184.                     Avoid EXE, COM or BAT for abbreviations and be con-
  185.                     sistent once an abbreviation is selected for a spe-
  186.                     cific bulletin board.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.          SEARCH - The BBS Message Searcher Version 1.32        Page -4-
  201.  
  202.              Copyright (C) 1989 by Don Lewis.  All rights reserved.
  203.  
  204.  
  205.  
  206.               2)    Create a file named SRCHTITL.NNN, where the NNN is
  207.                     the BBS name abbreviation used in step 1.  This file
  208.                     must contain three (and ONLY three) words.  The first
  209.                     word will be found at the very beginning of each mes-
  210.                     sage on the bulletin board, the second begins the
  211.                     line where message subject is shown and the third
  212.                     word is found at the beginning of the last line of
  213.                     each message (see procedure and example messages in
  214.                     Appendix A).
  215.  
  216.                     These words are placed there by the BBS software, not
  217.                     by the message sender, and ** MUST ** appear in
  218.                     SRCHTITL.NNN exactly as they do in the downloaded
  219.                     messages (uppercase, lowercase, and any punctuation).
  220.  
  221.               3)    Create a file of search words named SEARCH.LST.  A
  222.                     search word may contain letters, numbers, spaces or
  223.                     punctuation. Words may be composed of UPPERCASE, low-
  224.                     ercase or Mixed Case letters; SEARCH doesn't care and
  225.                     will find the letter sequence without reference to
  226.                     case.
  227.  
  228.                     A word may be any length, but the longer it is, the
  229.                     slower SEARCH runs, and the less likely it is that a
  230.                     matching word will be found.  Words are searched at
  231.                     full length, but are shortened to 8 characters for
  232.                     the screen display.
  233.  
  234.                     Use only one word per line, 39 words maximum per
  235.                     search (more are ignored).  Don't get too fancy with
  236.                     the punctuation and spaces in the word, because
  237.                     SEARCH looks for an ** EXACT ** match, and it is hard
  238.                     to predict how someone who sends a message w